home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / dmedia / synthpanel.z / synthpanel
Text File  |  1998-10-30  |  20KB  |  331 lines
  1.  
  2.  
  3.  
  4. ssssyyyynnnntttthhhhppppaaaannnneeeellll((((1111))))                                                    ssssyyyynnnntttthhhhppppaaaannnneeeellll((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      synthpanel - 16 channel MMMMIIIIDDDDIIII control panel
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ssssyyyynnnntttthhhhppppaaaannnneeeellll [[[[----nnnnooooffffoooorrrrkkkk]]]]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      ssssyyyynnnntttthhhhppppaaaannnneeeellll manages all 16 MIDI channels in a compact grid of 16 rows. It
  16.      also provides an interface through which synthesizer preset banks may be
  17.      added and selected for use with mmmmiiiiddddiiiissssyyyynnnntttthhhh(1).  On startup, ssssyyyynnnntttthhhhppppaaaannnneeeellll
  18.      polls the internal software synthesizer for its configuration.  Since
  19.      MIDI includes minimal provisions for query, ssssyyyynnnntttthhhhppppaaaannnneeeellll is unable to poll
  20.      external MIDI devices. You can also use ssssyyyynnnntttthhhhppppaaaannnneeeellll to monitor MIDI data
  21.      played by _s_o_u_n_d_p_l_a_y_e_r.
  22.  
  23. MMMMEEEENNNNUUUUSSSS
  24. AAAAddddmmmmiiiinnnn MMMMeeeennnnuuuu
  25.      Currently contains only the _E_x_i_t command.
  26.  
  27. MMMMIIIIDDDDIIII MMMMeeeennnnuuuu
  28.      Commands related to MIDI events.  Contains:
  29.  
  30.      IIIInnnnppppuuuutttt IIIInnnntttteeeerrrrffffaaaacccceeeessss submenu
  31.           Contains a menu item for each available, configured MIDI output
  32.           port.  Only one output port may be selected at a time.
  33.  
  34.      _A_l_l _N_o_t_e_s _O_f_f command
  35.           Sends a GM AAAAllllllll NNNNooootttteeeessss OOOOffffffff message on all 16 channels via the current
  36.           output port.
  37.  
  38.      _R_e_s_e_t _A_l_l _C_o_n_t_r_o_l_l_e_r_s command
  39.           Sends a GM RRRReeeesssseeeetttt AAAAllllllll CCCCoooonnnnttttrrrroooolllllllleeeerrrrssss message on all 16 channels via the
  40.           current output port.
  41.  
  42.      _R_e_s_t_a_r_t _S_y_n_t_h_e_s_i_z_e_r command
  43.           Causes mmmmiiiiddddiiiissssyyyynnnntttthhhh to terminate immediately;  a question dialog will
  44.           ask if you wish to restart it.  This is a brute-force technique, and
  45.           should be reserved for emergency use.  The previous two commands and
  46.           the All Sound Off button are usually sufficient.
  47.  
  48.      _S_y_n_t_h _S_y_s_t_e_m _R_e_s_e_t command
  49.           Sends the equivalent of the standard MMMMIIIIDDDDIIII SSSSyyyysssstttteeeemmmm RRRReeeesssseeeetttt message.
  50.           This resets mmmmiiiiddddiiiissssyyyynnnntttthhhh to its startup state and purges all loaded
  51.           banks, presets and sample files.
  52.  
  53. OOOOppppttttiiiioooonnnnssss MMMMeeeennnnuuuu
  54.      _S_y_n_t_h _S_t_a_r_t_u_p _C_o_n_f_i_g_u_r_a_t_i_o_n... command
  55.           Brings up the MIDISynth Startup Configuration Panel, allowing you to
  56.           customize the startup configuration file for mmmmiiiiddddiiiissssyyyynnnntttthhhh and save the
  57.           result to your home directory as ._m_i_d_i_s_y_n_t_h_r_c.  Changes made to the
  58.           Panel settings and to this file will not affect the currently
  59.           running synthesizer;  use the above-described _R_e_s_t_a_r_t _S_y_n_t_h_e_s_i_z_e_r
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ssssyyyynnnntttthhhhppppaaaannnneeeellll((((1111))))                                                    ssssyyyynnnntttthhhhppppaaaannnneeeellll((((1111))))
  71.  
  72.  
  73.  
  74.           command to restart with the new settings.
  75.  
  76.      _S_y_n_t_h _R_u_n_t_i_m_e _P_a_r_a_m_e_t_e_r_s... command
  77.           Brings up the Run Time Parameters Panel, allowing you to set the
  78.           Main Transpose, Main Tune, Reverberation, and Chorus parameters for
  79.           the internal synthesizer. These parameters are set via system
  80.           exclusive MIDI events, and will not affect external MIDI devices.
  81.           Reverberation choices simulate four rooms of varying size.  Reverb
  82.           decay time, tone, and effects mix ratio may be varied for each room
  83.           type.
  84.  
  85.      _G_e_n_e_r_a_l _M_I_D_I _P_r_e_s_e_t _M_o_d_e toggle.
  86.           This sends a Universal System Exclusive MIDI message which toggles
  87.           the General MIDI mode setting of any synthesizer which understands
  88.           the message.
  89.  
  90. SSSSoooouuuunnnnddddssss MMMMeeeennnnuuuussss
  91.      Commands for opening directories in order to view MIDI files,
  92.      ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt(4) files, and sound files.
  93.  
  94.      _M_I_D_I _S_o_n_g_s command
  95.           Brings up a ddddiiiirrrrvvvviiiieeeewwww(1) showing the contents of the directory
  96.           /_u_s_r/_s_h_a_r_e/_d_a_t_a/_m_u_s_i_c, which is where the sample MIDI data files are
  97.           stored.  Double-clicking on any MIDI file icon will bring up
  98.           ssssoooouuuunnnnddddppppllllaaaayyyyeeeerrrr(1), which will play the MIDI file via mmmmiiiiddddiiiissssyyyynnnntttthhhh(1).
  99.  
  100.      PPPPrrrreeeesssseeeettttssss submenu
  101.           Each menu item brings up a ddddiiiirrrrvvvviiiieeeewwww(1) showing the contents of the
  102.           various subdirectories under /_u_s_r/_s_h_a_r_e/_d_a_t_a/_s_o_u_n_d_s/_s_y_n_t_h/_p_r_e_s_e_t_s,
  103.           which is where the preset files used by the internal synthesizer are
  104.           stored. The two commands are _G_e_n_e_r_a_l _M_I_D_I (GM presets) and _G_o_l_d_e_n
  105.           _A_n_a_l_o_g (example presets which attempt to immitate analog synthesizer
  106.           sounds).
  107.  
  108.      SSSSoooouuuunnnndddd FFFFiiiilllleeeessss submenu
  109.           Each menu item brings up a ddddiiiirrrrvvvviiiieeeewwww(1) showing the contents of the
  110.           various subdirectories under
  111.           /_u_s_r/_s_h_a_r_e/_d_a_t_a/_s_o_u_n_d_s/_s_y_n_t_h/_s_o_u_n_d_f_i_l_e_s, which is where the sample
  112.           soundfiles used by the internal synthesizer are stored. The four
  113.           commands are _G_e_n_e_r_a_l _M_I_D_I _S_o_u_n_d _S_e_t (sounds for GM presets), _G_e_n_e_r_a_l
  114.           _M_I_D_I _P_e_r_c_u_s_s_i_o_n _M_a_p (sounds for percussion preset), _C_y_c_l_e_s (waveform
  115.           sounds for LFOs), and _P_r_o_s_o_n_u_s _S_a_m_p_l_e_r (additional demonstration
  116.           sample sounds).
  117.  
  118. UUUUttttiiiilllliiiittttiiiieeeessss MMMMeeeennnnuuuu
  119.      Commands for starting up other useful audio and/or MIDI applications.
  120.  
  121.      _A_u_d_i_o _C_o_n_t_r_o_l _P_a_n_e_l
  122.           Invokes aaaappppaaaannnneeeellll(1)
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ssssyyyynnnntttthhhhppppaaaannnneeeellll((((1111))))                                                    ssssyyyynnnntttthhhhppppaaaannnneeeellll((((1111))))
  137.  
  138.  
  139.  
  140.      _S_y_n_t_h_e_s_i_z_e_r _E_d_i_t_o_r
  141.           Invokes the new ssssyyyynnnntttthhhheeeeddddiiiittttoooorrrr(1) tool
  142.  
  143.      _M_I_D_I _K_e_y_b_o_a_r_d
  144.           Invokes mmmmiiiiddddiiiikkkkeeeeyyyyssss(1)
  145.  
  146.      _S_o_u_n_d_P_l_a_y_e_r
  147.           Invokes ssssoooouuuunnnnddddppppllllaaaayyyyeeeerrrr(1)
  148.  
  149. MMMMAAAAIIIINNNN PPPPAAAANNNNEEEELLLL LLLLAAAAYYYYOOOOUUUUTTTT
  150. CCCCHHHHAAAANNNNNNNNEEEELLLL DDDDIIIISSSSPPPPLLLLAAAAYYYY PPPPAAAANNNNEEEELLLL
  151.      Each channel row contains:
  152.  
  153.      _M_I_D_I _I_n_p_u_t _A_c_t_i_v_i_t_y _I_n_d_i_c_a_t_o_r
  154.           The indicator flashes on receipt of any MIDI event except SSSSyyyysssstttteeeemmmm
  155.           EEEExxxxcccclllluuuussssiiiivvvveeee, CCCCoooommmmmmmmoooonnnn and RRRReeeeaaaallll----TTTTiiiimmmmeeee events.  The light does not hold for
  156.           the duration of a note.  Rather, it flashes briefly for each NNNNooootttteeee OOOOnnnn
  157.           and NNNNooootttteeee OOOOffffffff event.
  158.  
  159.      _C_h_a_n_n_e_l _A_c_t_i_v_a_t_o_r _B_u_t_t_o_n
  160.           This determines whether the internal synthesizer generates sounds on
  161.           a particular channel.
  162.  
  163.      _P_l_a_y _B_u_t_t_o_n (note# 66660000 or CCCC4444)
  164.           Pressing this button will send a NNNNooootttteeee OOOOnnnn event on the selected
  165.           channel at maximum velocity (127).  Releasing it sends the
  166.           corresponding NNNNooootttteeee OOOOffffffff.  The pitch cycles through four octaves of
  167.           the note 'C', changing with each button press.
  168.  
  169.      _P_r_e_s_e_t _I_c_o_n _D_r_o_p _P_o_c_k_e_t
  170.           Dragging a ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt(4) file into this pocket will cause that
  171.           preset to be loaded on the chosen channel.  For the internal
  172.           synthesizer, this operation can be done independent of the GGGGeeeennnneeeerrrraaaallll
  173.           MMMMIIIIDDDDIIII mode and of the current preset bank:  Any arbitrary preset from
  174.           any directory may be used.
  175.  
  176.           Preset icons will not change presets on external MIDI devices unless
  177.           you operate in GGGGeeeennnneeeerrrraaaallll MMMMIIIIDDDDIIII mode, in which case ssssyyyynnnntttthhhhppppaaaannnneeeellll attempts
  178.           to extract a number from the beginning of a file name and transmit
  179.           that number as a MIDI program change.  See the section _P_R_E_S_E_T _F_I_L_E
  180.           _N_A_M_I_N_G _C_O_N_V_E_N_T_I_O_N_S in the ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt(4) man page for more
  181.           information on this.
  182.  
  183.      _P_r_e_s_e_t _N_u_m_b_e_r
  184.           Typing a number between 1 and 128 in the text entry field following
  185.           by the <return> key will cause ssssyyyynnnntttthhhhppppaaaannnneeeellll to send a program change
  186.           event on the corresponding channel for that number.  Note that this
  187.           is very different than dropping presets in the pocket:  The
  188.           resulting preset will be the corresponding entry in the current
  189.           preset bank.  If that bank is a GGGGeeeennnneeeerrrraaaallll MMMMIIIIDDDDIIII bank, the preset will
  190.           match the GM specification for that number.  For example, preset #73
  191.           is the Flute preset.  If the current bank is not a GM bank and does
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ssssyyyynnnntttthhhhppppaaaannnneeeellll((((1111))))                                                    ssssyyyynnnntttthhhhppppaaaannnneeeellll((((1111))))
  203.  
  204.  
  205.  
  206.           not contain a preset for the number entered, the resulting preset
  207.           will be the lowest available value from the bank (usually preset 1).
  208.           If no number is entered in the text entry field, and the <return>
  209.           key is pressed, ssssyyyynnnntttthhhhppppaaaannnneeeellll will instruct mmmmiiiiddddiiiissssyyyynnnntttthhhh to load the
  210.           DDDDeeeeffffaaaauuuulllltttt preset:  One Sawtooth-wave oscillator with two detuned
  211.           siblings, controlled by one amplitude envelope with a zero-second
  212.           rise time one-second decay time, and no sustain.  See the
  213.           ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt(4) man page for details.
  214.  
  215.      _P_r_e_s_e_t _N_a_m_e _L_a_b_e_l
  216.           This label displays the name of the current preset.  For
  217.           ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt(4) files, this will be the value of the Name: string in
  218.           the Information section, if present, otherwise ssssyyyynnnntttthhhhppppaaaannnneeeellll will
  219.           create a name from the file name by clipping off the number prefix,
  220.           if present, and the ".preset" suffix, if present.  For other types
  221.           of preset files, such as those found in preset bank files, the name
  222.           is extracted from the appropriate data in the file.
  223.  
  224. TTTTHHHHEEEE ''''MMMMOOOORRRREEEE'''' PPPPAAAANNNNEEEELLLL
  225.      The MMMMoooorrrreeee////LLLLeeeessssssss Arrow Button expands the channel layout to include MIDI
  226.      PPPPaaaannnn, VVVVoooolllluuuummmmeeee and EEEExxxxpppprrrreeeessssssssiiiioooonnnn indicators.  Actual MIDI channel volume is
  227.      calculated by multiplying the VVVVoooolllluuuummmmeeee and EEEExxxxpppprrrreeeessssssssiiiioooonnnn and dividing by 16129
  228.      (127 squared).  This follows the General MIDI Level 1 Specification.
  229.      Standard practice dictates that the default level for the VVVVoooolllluuuummmmeeee should
  230.      be 111100000000 and should be 111122227777 for the EEEExxxxpppprrrreeeessssssssiiiioooonnnn.
  231.  
  232. TTTTHHHHEEEE PPPPRRRREEEESSSSEEEETTTT BBBBAAAANNNNKKKKSSSS PPPPAAAANNNNEEEELLLL
  233.      The SSSShhhhoooowwww////HHHHiiiiddddeeee BBBBaaaannnnkkkkssss Arrow Button expands the main panel to include an
  234.      additional panel with eight rows.  Each row contains:
  235.  
  236.      BBBBaaaannnnkkkk NNNNuuuummmmbbbbeeeerrrr aaaannnndddd SSSSeeeelllleeeecccctttt BBBBuuuuttttttttoooonnnn
  237.           Each button is labeled with the index number of this preset bank.
  238.           Selecting a bank un-selects all other banks and causes all
  239.           subsequent program change messages to use presets from this bank.
  240.           Currently-selected presets will remain unchanged until a program
  241.           change message is sent on that preset's channel (or a new preset is
  242.           dropped into the Preset Drop Pocket).
  243.  
  244.      BBBBaaaannnnkkkk DDDDrrrroooopppp PPPPoooocccckkkkeeeetttt
  245.           Dragging either a directory or a _S_o_u_n_d_F_o_n_t_2-compatible preset bank
  246.           file into this pocket will either 1111)))) tell the internal synthesizer
  247.           to regard that directory as a holder of 128 + 1 General MIDI
  248.           ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt(4) files or 2222)))) tell the internal synthesizer to load the
  249.           preset bank file into its bank library.  This bank can then be
  250.           selected via the select button if desired.  If a directory is
  251.           dropped in the slot, mmmmiiiiddddiiiissssyyyynnnntttthhhh(1) will not load any of the preset
  252.           files until the bank is selected and a program change event is sent.
  253.           At that time the internal synth will attempt to locate a preset file
  254.           which matches the requested program number.  See the _P_r_e_s_e_t _I_c_o_n
  255.           _D_r_o_p _P_o_c_k_e_t description above for more information.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. ssssyyyynnnntttthhhhppppaaaannnneeeellll((((1111))))                                                    ssssyyyynnnntttthhhhppppaaaannnneeeellll((((1111))))
  269.  
  270.  
  271.  
  272.           The default preset bank is the directory
  273.           /_u_s_r/_s_h_a_r_e/_d_a_t_a/_s_o_u_n_d_s/_s_y_n_t_h/_p_r_e_s_e_t_s/_G_e_n_e_r_a_l_M_I_D_I__S_o_u_n_d_S_e_t_L_e_v_e_l_1.
  274.           This is installed from the dmedia_eoe.data.synth image on the IRIX
  275.           CDROM.  See the mmmmiiiiddddiiiissssyyyynnnntttthhhh(1) man page for information on how to
  276.           change this and other default values.
  277.  
  278.      BBBBaaaannnnkkkk NNNNaaaammmmeeee LLLLaaaabbbbeeeellll
  279.           The name of the preset bank file, or the last portion of the
  280.           directory name.
  281.  
  282. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  283.      ----hhhheeeellllpppp
  284.           Print usage statement.
  285.  
  286.      ----nnnnooooffffoooorrrrkkkk
  287.           Do not go into the background.  By default, ssssyyyynnnntttthhhhppppaaaannnneeeellll forks itself
  288.           to give control back to the shell.
  289.  
  290. HHHHAAAARRRRDDDDWWWWAAAARRRREEEE
  291.      _s_y_n_t_h_p_a_n_e_l works only on Iris Indigo R4000, Indigo2, Indy, O2, Octane,
  292.      and Onyx/Challenge machines fitted with the SGI Audio Option (ASO) Board.
  293.  
  294. WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
  295.      Some ssssyyyynnnntttthhhhppppaaaannnneeeellll operations do not control external MIDI devices because
  296.      the MIDI messages are system exclusive for the SGI software synthesizer:
  297.      Main Gain(dB), Main Tune, Reverberation, Channel activate and preset name
  298.      (those that does not start with numerical characters).  A MIDI program
  299.      change# is extracted from Synth Preset file names that begin with "XXX_",
  300.      where XXX= number in range [1..128]
  301.  
  302.      The version of the Synthesizer Panel and Software Synthesizer shipped
  303.      with IRIX 6.5 is incompatible with earlier versions of these products.
  304.      Attempting to use the new 2.0 Panel with an earlier release of mmmmiiiiddddiiiissssyyyynnnntttthhhh
  305.      (or vice versa) will result in garbled communication and unpredictable
  306.      results.
  307.  
  308. BBBBUUUUGGGGSSSS
  309.      There is currently no way to select GS preset variations via ssssyyyynnnntttthhhhppppaaaannnneeeellll,
  310.      even though mmmmiiiiddddiiiissssyyyynnnntttthhhh(1) will respond to BBBBAAAANNNNKKKK____SSSSEEEELLLLEEEECCCCTTTT MIDI messages and
  311.      can load GS preset banks.
  312.  
  313. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  314.      midisynth(1), midikeys(1), soundplayer(1), syntheditor(1), synthpreset(4)
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.